Introdução ao RMarkdown

Aula 2, M1

Carolina Musso

Sala de Situação - UnB

Lembrando…

Agora, um pouquinho de teoria

  • RMarkdown foi criado sob o paradigma da Programação literária

  • Liguagem para humanos x liguagem para máquina

  • Resumo: Rmardown tem o melhor dos dois mundos 🌍 🌎

  • Vejamos um exemplo!

  • Curiosidade: Quem inventou foi o Yihui engenheiro do RStudio pra fazer o dever de casa quando tava na faculdade … 😑)

Muitas análises

Pouco tempo de analisalas

  • Muito tempo + softwares + profissionais

    • Maior possibilidade de erro

Documentos reprodutíveis

  • Economia de tempo

  • Não ficam atreladas a uma pessoa

Vamos ver algo especial do R

  • Bem diferente de como foi criado nos anos 90

  • Rmarkdown

  • Quarto

Agora faça como eu!

Você conseguiu diferenciar essas partes?

  • Cabeçalho

  • Texto

  • Código

Cabeçalho

  • Metadados

  • Linguagem YAML

  • É MUITO sensível (qualquer coisa atrapalha)

Texto

  • Markdown

Código

  • É o coração do R mesmo

    • Linguagem de programação

    • Como que difere de Excel (apontar e clicar?)

Recapitulando

O Rmarkdwon tem três partes.

Cabeçalho:

  • Características:

    • Linguagel YAML

    • Bizarro

    • Sensível a indentação

    • É onde estão os metadados

    • Vamos mexer pouco nele, mas vamos mexer…

  • COM CUIDADO!

  • pra não dar ruim

Exercício do cabeçalho

  • Primeiro, salve o arquivo da aula com o seu nome no fim.

    • colocar seu nome e a data de hoje no cabeçalho
  • Será que dá pra data atualizar sozinha? 🤔

  • Vamos colocar isso no lugar da data lá no cabeçalho

`r Sys.Date()`
  • Mas esse formato de data é estranho …😩

  • Que tal tentar…

`r format(Sys.Date(), "%d/%m/%Y")`

Texto:

  • É onde está nosso diferencial!

  • Mas…você tem tempo de interpretar os dados?

  • Ou…já passou tanto tempo copiando e colando figuras e tabelas e atualizando cabeçalhos que simplesmente não teve tempo de interpretar os dados?

Texto:

O texto no RMarkdown está na linguagem Markdown (daí o nome), que é uma linguagem de marcação para possibilidar fazer umas “firulas”no texto simples.

  • No fundo é o que o e-mail, whatsapp usam por exemplo…

  • # Título, ## Subtítulo … aí por diante

  • Se colocar a palavra entre asteriscos *assim* ela fica em itálico, entre dois fica negrito

  • Também aceita fórmulas, imagens…

  • Mas o RStudio tem um macete também …

Exercício do texto

Vamos fazer um texto com uma breve interpretação dos dados. Algo curto só para dar um gostinho e usar algumas funcionalidades do Markdown ou da funcionalidade Visual Editor.

  • Vocês têm 10 minutos

O código 😈

  • Programação é algo bem abstrado… temos de escrever de um jeito que a máquina vai entender…

  • Basicamente a vamos escrever um monte de comandos, de um jeito e em uma ordem muito específicos, porque o computador não é tão inteligente assim…

  • Qual a vantagem disso? A máquina não cansa de fazer coisa repetitiva (ainda não se revoltaram)

  • Liguagem R é difícil pra gente, mas por íncrível que pareça, é uma das mais amigáveis do mercado!

  • Ou seja, ainda dá pra não-programadores, como nós , se aventurarem, pra aprender e usarmos a nosso favor na nossa área de atuação.

O chamado chunk

  • O chunk são esses pedaços em cinza onde os códigos estão escritos.

  • Eles podem ser em várias linguagens de programação, mas nós vamos usar só o R.

  • Dentro dos chunks há três coisas importantes

    • o código em si, que é o que “corre”

    • os comentários, que servem para se organizar, melhorar a colaboração …

    • os parâmetros do chunk

Mas tém código em outro lugar

  • O chamado código inline

  • Perceberam isso no arquivo? Como estava?

  • Tente trocar o valor que aparece dos do Brazil para os Estados Unidos

Brincando com o código

Comentários

  • Comente com o # a alteração que você fez no fim da linha

  • Crie com comentário em uma nova lina e aciona —- (quatro tracinhos) no no final dessa linha. O que aconteceu?

Oh tem um íncice! 😮

Outros parâmetros interessantes …

  • Se mantendo organizado …
    • Títulos nos chunks (cuidado!)

    • Seções de comentários

    • Seções no texto com os #

    • Tudo isso vai pro índice e te ajuda a navegar no código

Parâmetros do chunk

Para hoje, vamos ver:

  • título no chunk

  • include= (se a saída, mensagens, warnings gerados nesse chunk vão ser incluídos no arquivo compilado )

  • echo= (se o código será incluído no arquivo compilado)

Kahoot do dia!